PHP 4, PHP 5, PHP 6. https:// a partir de PHP 4.3.0
Permite acceso de sólo-lectura a archivos/recursos a través de HTTP 1.0, usando el método HTTP GET. Una cabecera Host: es enviada con la petición para gestionar hosts virtuales basados en nombres. Si ha configurado una cadena user_agent usando su archivo ini o en el contexto de secuencia, también ésta será usada en la petición.
Cuando se usa SSL, Microsoft IIS violara el protocolo, cerrando la conexion sin mandar un indicador close_notify. PHP avisara de esto con este mensaje "SSL: Fatal Protocol Error", cuando llegue al final de los datos. Una solucion a este problema es bajar el nivel de aviso de errores del sistema para que no incluya advertencias. PHP 4.3.7 y versiones posteriores detectan servidores IIS con este problema y suprime la advertencia. Si usais la funcion fsockopen() para crear un socket ssl://, tendreis que suprimir la advertencia explicitamente.
Las redirecciones han sido soportadas desde PHP 4.0.5; si se encuentra usando una versión anterior, necesitará incluir barras de cierre en sus URLs. Si es importante conocer la URL del recurso del cual proviene su documento (luego de que todas las redirecciones han sido procesadas), necesitará trabajar con la serie de cabeceras de respuesta devueltas por la secuencia.
<?php
$url = 'http://www.example.com/pagina_de_redireccion.php';
$da = fopen($url, 'r');
/* Antes de PHP 4.3.0, use $http_response_header
en lugar de stream_get_meta_data() */
$meta_datos = stream_get_meta_data($da);
foreach($meta_datos['wrapper_data'] as $respuesta) {
/* ¿Fuimos redirigidos? */
if (substr(strtolower($respuesta), 0, 10) == 'location: ') {
/* actualizar $url con la ubicación desde donde fuimos redirigidos */
$url = substr($respuesta, 18);
}
}
?>
La secuencia permite acceso al cuerpo del recurso; las cabeceras son almacenadas en la variable $http_response_header. A partir de PHP 4.3.0, las cabeceras están disponibles mediante el uso de stream_get_meta_data().
Las conexiones HTTP son de sólo-lectura; no puede escribir datos o copiar archivos hacia un recurso HTTP.
Note: HTTPS es soportado a partir de PHP 4.3.0, si ha compilado el soporte para OpenSSL.
| Atributo | Soporte |
|---|---|
| Restricción por allow_url_fopen | Si |
| Permite Lectura | Si |
| Permite Escritura | No |
| Permite Adición | No |
| Permite Lectura y Escritura Simultánea | N/D |
| Soporte stat() | No |
| Soporte unlink() | No |
| Soporte rename() | No |
| Soporte mkdir() | No |
| Soporte rmdir() | No |
Es posible enviar cabeceras personalizadas con una petición HTTP antes de la versión 5 aprovechando un efecto lateral en el manejo del parámetro INI user_agent. Defina user_agent con cualquier cadena válida (tal como el valor PHP/version predeterminado) seguido de una pareja retorno-de-carro/salto-de-línea y cualquier conjunto de cabeceras adicionales. Este método funciona en PHP 4 y todas las versiones posteriores.
Example #1 Envío de cabeceras personalizadas con una petición HTTP
<?php
ini_set('user_agent', "PHP\r\nX-MiCabeceraPersonalizada: Foo");
$fp = fopen('http://www.example.com/index.php', 'r');
?>
Resulta en el envío de la siguiente petición:
GET /index.php HTTP/1.0 Host: www.example.com User-Agent: PHP X-MiCabeceraPersonalizada: Foo